package com.atguigu.tingshu.album.service;

import com.atguigu.tingshu.dto.AlbumSaveOrUpdateDTO;
import com.atguigu.tingshu.model.album.AlbumInfo;
import com.atguigu.tingshu.query.album.AlbumInfoQuery;
import com.atguigu.tingshu.vo.album.AlbumInfoVo;
import com.atguigu.tingshu.vo.album.AlbumListVo;
import com.atguigu.tingshu.vo.album.AlbumStatVo;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;

import java.util.List;

public interface AlbumInfoService extends IService<AlbumInfo> {

    /**
     * 描述:新增专辑
     *
     * @param userId       用户ID
     * @param albumInfoDTO 专辑信息
     * @return
     * @author daiyuling
     * @date 2025/10/24
     */
    Boolean saveAlbumInfo(Long userId, AlbumSaveOrUpdateDTO albumInfoDTO);

    /**
     * 根据id查询专辑信息
     *
     * @param id
     * @return
     * @author daiyuling
     * @date 2025/10/24
     */
    AlbumInfoVo getAlbumInfoById(Long id);

    /**
     * 描述：分页查询用户专辑信息
     *
     * @param page
     * @param limit
     * @param albumInfoQuery
     * @return
     * @author daiyuling
     * @date 2025/10/25
     */
    Page<AlbumListVo> findUserAlbumPage(Long page, Long limit, AlbumInfoQuery albumInfoQuery);

    /**
     * 描述：删除专辑信息
     *
     * @param id
     * @return boolean
     * @author daiyuling
     * @date 2025/10/25
     */
    boolean removeAlbumInfo(Long id);

    /**
     * 描述：修改专辑信息
     *
     * @param id
     * @param albumSaveOrUpdateDTO
     * @author daiyuling
     * @date 2025/10/27
     */
    void updateAlbumInfo(Long id, AlbumSaveOrUpdateDTO albumSaveOrUpdateDTO);

    /**
     * 描述：查询所有专辑信息
     *
     * @author daiyuling
     * @date 2025/10/27
     */
    List<AlbumInfoVo> findUserAllAlbumList();

    /**
     * 获取专辑的统计信息
     *
     * @param albumId 专辑ID
     * @return 专辑统计信息
     */
    AlbumStatVo getAlbumStatVo(Long albumId);
}
